home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr37 / isr100a.zip / ISERVER.DOC < prev    next >
Text File  |  1995-02-25  |  18KB  |  401 lines
  1.  
  2.    ▀  █▀▀ █▀▀ █▀█ █ █ █▀▀ █▀█
  3.    █  ▀▀█ █▀  █▀▄ █ █ █▀  █▀▄  I n t e r n e t   S e r v e r   R e l a y
  4.    ▀  ▀▀▀ ▀▀▀ ▀ ▀  ▀  ▀▀▀ ▀ ▀
  5.  
  6.    Copyright Mulitboard Communications Centre, 1995
  7.    All rights reserved.
  8.  
  9.  
  10.  
  11.  WHAT DOES THIS PROGRAM DO?
  12.  ══════════════════════════════════════════════════════════════════════─────
  13.  
  14.    This program imports and exports netmail into your BBS's message
  15.    base, in a way that is compatible with netmail, but to the user
  16.    it appears as internet mail.  It also provides many internet
  17.    commands and functions.
  18.  
  19.  
  20.  
  21.  WHAT DO I NEED TO SET THIS PROGRAM UP?
  22.  ══════════════════════════════════════════════════════════════════════─────
  23.  
  24.   In order to use this program you will need:
  25.  
  26.    1) Your system to use fidonet style *.MSG files for netmail
  27.    2) A BBS that uses the JAM message format (other formats to come soon)
  28.    3) About 10 minutes to set it up
  29.  
  30.   Setup method:
  31.  
  32.    1) Create a message base on your BBS.  For RemoteAccess, it should
  33.       be an Internet style area, JAM type.
  34.    2) Make the modifications as needed to the ISERVER.CFG file.
  35.    3) Put ISERVER.EXE in your RUNBBS.BAT file, after receiving netmail
  36.       and after the user logs off (or optionally during an event)
  37.    4) You're done.
  38.  
  39.   The easiest way to setup this system is by editing the ISERVER.CFG
  40.   file to match your setup.  You can refer to this appendix for more
  41.   information about a particular option if required.
  42.  
  43.  
  44.  
  45.  WHAT CAN'T I DO UNTIL I REGISTER?
  46.  ══════════════════════════════════════════════════════════════════════─────
  47.  
  48.    Nothing.  The only limits that are imposed, are that you can only
  49.    have a maxium of 5 RESPOND entries, and 5 RESTRICTS until registered.
  50.    It will also remove the unregistered notice, and 2 second delay.
  51.    Please register, a lot of effort went into developing the program,
  52.    and the price is quite reasonable.
  53.  
  54.  
  55.  
  56.  CONFIGURATION COMMANDS (Explanations and examples)
  57.  ══════════════════════════════════════════════════════════════════════─────
  58.  
  59.    Quick note, where addresses have no points, do not specify the
  60.    point zero.  For example, 1:2401/305 should not be entered as
  61.    1:2401/305.0, or it may not be processed correctly.
  62.  
  63.  
  64.    PROCESS             -  These are the addresses that iSERVER should
  65.                           process for internet mail.  If you have more
  66.                           than one domain setup, you can enter multiple
  67.                           addresses.  (Maximum 10 addresses)
  68.  
  69.                           Example: PROCESS 1:2401/305.999
  70.  
  71.  
  72.    NETMAIL             -  This is the path to the *.MSG netmail
  73.                           messages that come into and leave your
  74.                           system from.
  75.  
  76.                           Example: NETMAIL e:\fd\mail
  77.  
  78.  
  79.    UPDATE              -  These are files you would like created after
  80.                           netmail has been edited, created or deleted.
  81.                           They are semaphore files used to inform other
  82.                           tasks to rescan the netmail folders.
  83.                           (Maximum of 10 update files)
  84.  
  85.                           Example: UPDATE e:\fd\FDRESCAN.NOW
  86.  
  87.  
  88.    XADDRESS            -  Not normally needed, but it allows you to
  89.                           readdress an outgoing message.  If the
  90.                           message is addressed to the first address,
  91.                           it will be readdressed to the second address.
  92.                           It is mainly used for rerouting messages
  93.                           from one gateway to another.  (Maximum of
  94.                           30 xaddresses)
  95.  
  96.                           Example:  XADDRESS 1:1/31  1:2235/10.999
  97.  
  98.  
  99.    PROCESS             -  These are automated process requests.  They
  100.                           can be very powerful for responding to
  101.                           messages, much like an automated full internet
  102.                           server.  If a message is addressed to the
  103.                           first parameter, it will send the file listed
  104.                           as the second parameter.  Optionally, if
  105.                           the second parameter begins with an asterisk
  106.                           "*", it will execute the second parameter.
  107.                           It will create a REQUEST file with the message
  108.                           information, and read back a RESPONSE text
  109.                           file, and post it if it exists.  Also, a third
  110.                           parameter can be added that will replace the
  111.                           subject line of the returning message (if any).
  112.  
  113.                           Example: RESPOND HELP   e:\fd\iserver\HELP.TXT
  114.                                    RESPOND RUNME *e:\fd\iserver\RUN.BAT
  115.  
  116.    IGNORE              -  Messages addressed to 'ignored' names will
  117.                           remain in the netmail folder as if iSERVER
  118.                           never even saw them.  It is good for leaving
  119.                           requests upto other programs, for example:
  120.                           ALLFIX, etc..  Also, if you wish your
  121.                           personal mail to be leave in your netmail
  122.                           folder, you can place your name in an ignore.
  123.                           (Maximum 30 ignores)
  124.  
  125.                           Example: IGNORE allfix
  126.                                    IGNORE pete rocca
  127.  
  128.  
  129.    USERS               -  This is for specifying the user list for
  130.                           users on your system.  By using this function
  131.                           iSERVER will automatically return undeliverable
  132.                           messages due to 'user unknown'. This is a great
  133.                           feature as messages sent to users that don't
  134.                           exist will be returned, rather than sit in
  135.                           your internet area, never able to be read.
  136.                           (Maximum 4000 users, for systems with more
  137.                           than 4000 users, please contact me at
  138.                           support@mcc.uti.com for information about a
  139.                           customized copy)
  140.  
  141.                           The second parameter specifies the type of
  142.                           user listing, either RA2 for RemoteAccess 2.x
  143.                           style BBS, or ASCII for a straight ASCII list
  144.                           of names.  The RA2 parameter checks both the
  145.                           users name and alias for validity.
  146.  
  147.                           The third parameter is the path to the user
  148.                           base for RA2, or the filename of the ASCII
  149.                           text file. (Use one method only)
  150.  
  151.                           Example: USERS RA2   e:\ra\msgbase
  152.                                or: USERS ASCII e:\fd\userlist.txt
  153.  
  154.  
  155.    UUCP_ADDRESS        -  This is the address of your gateway.  If you
  156.                           are using the standard Zone 1 gate, then it
  157.                           would be 1:1/31, otherwise place your private
  158.                           gate address here.
  159.  
  160.                           Example: UUCP_ADDRESS 1:2235/10.999
  161.  
  162.  
  163.    SITE_ADDRESS        -  This is the fido-style address that internet
  164.                           netmail will be addressed to.
  165.  
  166.                           Example: SITE_ADDRESS 1:2401/305.999
  167.  
  168.  
  169.    SITE_NAME           -  This is the name of your BBS's internet site.
  170.                           If you are using the fidonet gateway, then it
  171.                           will be something like:  p305.n2401.z1
  172.                           depending on your regular netmail address.
  173.  
  174.                           Example: SITE_NAME mcc.uti.com
  175.                                or: SITE_NAME p305.n2401.f1
  176.  
  177.  
  178.    SITE_BASE           -  This is the path to the message base you will
  179.                           be using to import/export messages from.
  180.                           Currently the only supported format is JAM.
  181.                           The first paramater is the base type, and
  182.                           the second is the path to the base.
  183.  
  184.                           Example: SITE_BASE JAM e:\ra\jam\EMAIL
  185.  
  186.  
  187.    SITE_SERVERNAME     -  Here you can customize what who you want to
  188.                           have listed on the 'from' for automated
  189.                           responsed.  The normal might be 'server' or
  190.                           'main-daemon'.  This is just for cosmetics.
  191.  
  192.                           Example: SITE_SERVERNAME server
  193.                                or: SITE_SERVERNAME mail-daemon
  194.  
  195.  
  196.    LOG                 -  This is just the path and filename of the
  197.                           log you would like created.
  198.  
  199.                           Example: LOG e:\ra\ISERVER.LOG
  200.  
  201.  
  202.    RESTRICT            -  This is one of the most powerful features
  203.                           of iSERVER that will allow you to setup
  204.                           subscription levels, or simply restrict
  205.                           access to certain functions if your gateway
  206.                           is long distance, or does not accept certain
  207.                           types of functions.
  208.  
  209.                           The first parameter is the name of the
  210.                           function you wish to restrict.  Any outgoing
  211.                           messages that have any of these names or
  212.                           partial matches of these names in the 'to'
  213.                           address or the first word in the subject line,
  214.                           they will be considered to be restricted.
  215.  
  216.                           Optionally (if using RemoteAccess 2.x), you
  217.                           can place a flag value (from A1 to D8) and
  218.                           if the user posting the message has that
  219.                           flag, they will be able to override this
  220.                           restriction.  (Maximum 50 restricts)
  221.  
  222.                           Example: RESTRICT SUBSC       A2
  223.                                    RESTRICT LISTSERV    A2
  224.                                    RESTRICT FTP
  225.  
  226.  
  227.    ALLOW_UUENCODED     -  By default, UUENCODED files are bounced
  228.                           when attempting to be exported, however
  229.                           you can override this for certain users,
  230.                           users with certain flags (RA 2.x), or for
  231.                           all users, using one of the following 3
  232.                           methods. (Maximum 50 entries)
  233.  
  234.                           Example: ALLOW_UUENCODED pete rocca
  235.                                    ALLOW_UUENCODED A2
  236.                                    ALLOW_UUENCODED
  237.  
  238.  
  239.    REGISTER            -  This is the function to enter your registration
  240.                           information into.  The first parameter is the
  241.                           serial number, and the second is the reg number.
  242.                           Please register, it is very inexpensive.
  243.  
  244.                           Example: REGISTER 00000 0000000000000000
  245.  
  246.  
  247.    One of the other nice features of iSERVER is the ability to
  248.    create handles/alias's that look like customized internet names.
  249.    (RA 2.x only) This is completely optional, and somewhat seperate
  250.    from the regular functions of iSERVER.  What is allows is for users
  251.    to enter an alias, and it checks it for duplicates, and also that
  252.    it conforms to standards you set, then updates the user's alias
  253.    record.  You would then setup your JAM base as an alias base, and
  254.    when messages were posted, they would be from the user's alias.
  255.    Incoming messages addressed to either the users full name or their
  256.    alias would be detected during a new mail scan still.  This allows
  257.    you to have user names like "admin@youraddress.com", rather than
  258.    "Pete.Rocca@youraddress.com", it's a nice touch to make your internet
  259.    system look more professional.
  260.  
  261.    The following options apply to this aspect.
  262.  
  263.  
  264.    MAX_HANDLE_LENGTH   -  This is the maximum length of a name the
  265.                           user can enter for thier own handle.
  266.  
  267.                           Example: MAX_HANDLE_LENGTH 40
  268.  
  269.  
  270.    MIN_HANDLE_LENGTH   -  This is the minimum length of a name the
  271.                           user can enter for thier own handle.
  272.  
  273.                           Example: MIN_HANDLE_LENGTH 5
  274.  
  275.  
  276.    SET_HANDLE_FLAG     -  You can have iSERVER mark in the user
  277.                           record once they have selected a valid
  278.                           name.  This is good for having an autoexec
  279.                           menu to run the userid part of the program
  280.                           if they do not have the flag set.
  281.  
  282.                           Example: SET_HANDLE_FLAG A1
  283.  
  284.  
  285.    BAD_HANDLE          -  These are parts of words you do not want
  286.                           the user to be able to enter as their
  287.                           handle.  Dedicated functions, obseen language
  288.                           and other personal preferences may be entered
  289.                           here. (Maximum of 50 entries)
  290.  
  291.                           Example: BAD_HANDLE ftp
  292.                                    BAD_HANDLE root
  293.                                    BAD_HANDLE serv
  294.  
  295.  
  296.  
  297.  COMMAND LINE PARAMETERS
  298.  ══════════════════════════════════════════════════════════════════════─────
  299.  
  300.    Typing ISERVER /? will bring up a list of command line options.
  301.    Normally, just running ISERVER.EXE is sufficient, but there are
  302.    other options available.
  303.  
  304.    Import/export mail parameters
  305.  
  306.       /PROCESS                   Standard behaviour (default)
  307.       /FORCE                     Ignore last scanning markers
  308.       /NOMARK                    Do not update high scan marks
  309.       /NOSCAN                    Do not scan for outgoing mail
  310.       /NOTOSS                    Do not toss incoming mail
  311.       /NOMGR                     Do not process requests/bounce unknown
  312.  
  313.    Online programs and parameters
  314.  
  315.       /USERID droppath           Userid creation (if flag not toggled)
  316.       /USERID droppath /FORCE    Userid creation (always)
  317.  
  318.  
  319.    The later two options are to run the userid (handle creation) part
  320.    of the program.  The /FORCE overrides if the user has the already
  321.    set the SET_HANDLE_FLAG flag.
  322.  
  323.  
  324.    Examples:  ISERVER.EXE /USERID c:\ra\node1 /FORCE
  325.               ISERVER.EXE /USERID c:\ra
  326.               ISERVER.EXE /USERID c:\ra\node2
  327.  
  328.  
  329.  
  330.  LICENSE AND DISCLAIMER
  331.  ══════════════════════════════════════════════════════════════════════─────
  332.  
  333.    "iSERVER" (also known as "ISR") is NOT free.     It is being marketed
  334.    under the "try before you buy" or shareware concept. You are entitled
  335.    to use ISR for a period up to  forty-five (45) days,  after which you
  336.    MUST register or stop using the program.
  337.  
  338.    Registration entitles you to  use ISR as  well as any future versions
  339.    of this program that may or may not be released, subject to any addi-
  340.    tional licensing conditions which may be attached.
  341.  
  342.    Registration  will also allow you to you the full ability of ISERVER
  343.    as well as remove the unregistered notice. It will also help to con-
  344.    tinue to develop this program. (not to mention maintain the legality
  345.    of this agreement)
  346.  
  347.    By running any of the  executable programs included,  you agree that
  348.    Pete Rocca,  Multiboard Communications Centre  nor any affiliates of
  349.    the above mentioned are responsible for any damage ever experienced,
  350.    however so created. If you cannot agree to this, then your privilege
  351.    to use any of these programs  is revoked  and it becomes illegal for
  352.    you to execute any programs included with this documentation.
  353.  
  354.    You may freely  copy and  distribute the shareware version of ISR as
  355.    long as its original archived contents  are not modified in any way.
  356.    You may NOT  distribute any  registration keys  without the  express
  357.    written  consent of Pete Rocca  of Multiboard Communications Centre.
  358.    You may not use a  registration  number  that is  not licensed from
  359.    Multiboard Communications Centre directly to you.
  360.  
  361.    It is illegal to edit, alter, hack, reverse engineer and / or modify
  362.    any components of the ISR archive in any manner.
  363.  
  364.    If dispute of any issues on legal grounds said above, then governing
  365.    law of Ontario, Canada will rule.
  366.  
  367.  
  368.  
  369.  SUPPORT
  370.  ══════════════════════════════════════════════════════════════════════─────
  371.  
  372.    If you have any questions or comments, you  can netmail me at FidoNet
  373.    address 1:2401/305 (CM,VFC,V32,V42).   You can also send your mail to
  374.    "support@mcc.uti.com" or "pete.rocca@mcc.uti.com".  In addition, the
  375.    newest MCC software is available via Internet FTP or Email.
  376.  
  377.    FTP: ftp.mcs.com (/mcsnet.users/bwolf)
  378.  
  379.  
  380.  
  381.  ACKNOWLEDGMENTS
  382.  ══════════════════════════════════════════════════════════════════════─────
  383.  
  384.    This program has been tested on  MS-DOS 3.3 through 6.22,  DESQview
  385.    2.40 through 2.63, DESQview/X 1.2 and 2.0, Windows 3.1 to 4.0 beta,
  386.    WindowsNT 3.x, OS/2 2.0 through OS/2 2.99 beta, and Novell DOS 7.0.
  387.    Other  operating  environments should work fine,  but they have not
  388.    been fully tested.  Requires at least DOS 3.3 and SHARE.EXE loaded.
  389.  
  390.    DESQview, Copyrighted by Quarterdeck Software;  MS-DOS, MS-Windows,
  391.    Copyrighted by Microsoft Corporation; OS/2, Copyright International
  392.    Business Machines Corp., Thanks to the public domain swapping utils
  393.    that required very little in the way of tweaking, by Thomas Wagner.
  394.    ISERVER/ISR are copyrighted products  by  Multiboard Communications
  395.    Centre and Pete Rocca.
  396.  
  397.    Remember, please register, it's cheap!
  398.  
  399.    Pete Rocca
  400.    Multiboard Communications Centre
  401.